home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 1 / Amiga Tools.iso / disk-tools / cd-tools / cddarip / cddarip.doc < prev    next >
Text File  |  1994-06-06  |  9KB  |  166 lines

  1.             
  2.             
  3.            CDDARIP.DOC     DOCUMENTATION FOR CDDARIP
  4.  
  5.                Version 0.90 on May 12, 1993
  6.  
  7.  
  8.     Cddarip is a new program that does the previously impossible.  It allows
  9. one to extract audio samples directly from an audio CD (CDDA).  Until the latest
  10. generation of drives (these expensive double speed drives), it was impossible to
  11. read audio samples through a CD-ROM player.  Most units had provisions to play
  12. the discs when it is not being used for computer data, and would often furnish
  13. computer programs to emulate the buttons on a standard audio CD player.  However,
  14. the units had their own DACs and audio was taken from a headphone or line output
  15. connected to the drive.  
  16.     This program is intended for the Toshiba XM-3401B drive.  It MAY work on
  17. similar models by Toshiba, and it is rumored the Apple CD300 is a similar drive
  18. inside.  CDDARIP has not been tested thereon.  It will not likely work on other
  19. manufacturers units, thought the latest Sony and NEC drives could have this 
  20. capability.
  21.     This program came to being out of curiosity.  I had obtained the Toshiba
  22. SCSI command manual to solve another problem(see fix_xa.lzh) and I discovered
  23. command capability to retrieve CDDA digital audio.  I wrote a short program to
  24. grab an arbitrary sample and save it as a raw 8 bit file.  I played back the
  25. result and low and behold, it sounded something like the original.
  26.     To make it usable, an interface had to be generated, and this was 70% of
  27. the programming time.  Plus everything is in BCD and some code had to be written
  28. to handle this.  The result is basically a CDDA control program (CDDARIP can
  29. be used for this just fine).  This allows the user to browse his CD to set the
  30. proper times to sample.  Then he can actually sample the data to disk.
  31.     Data from this can be used with other programs, as it puts it out in the
  32. standard IFF 8SVX format.  Think of it, your favorite guitar licks can come up
  33. when there is a system message with 2.0 or above.  
  34.     Cddarip was compiled with SAS/C ® 6.02.  It is designed to work with all
  35. 68000 family processors.  
  36.       
  37.  
  38. REQIREMENTS:
  39.  
  40. TOSHIBA XM-3401-B or similar 3400 series drive.  Apple CD300 MAY work not tested.
  41.  
  42. SCSI Interface that supports SCSI direct.  Tested on Amiga 3000.
  43.  
  44. Headphones or amplifier/speakers on 3401's audio output.
  45.  
  46. WorkBench/Kickstart (TM Commodore-Amiga inc) 2.04 or greater.
  47.  
  48. Note: It should NOT require any CD ROM filesystem as it accesses SCSI directly.
  49.  
  50. Hard disk for saving larger samples.  
  51.  
  52. USING CDDARIP:
  53.  
  54.     There is no special installation procedure.  Copy this file to any directory
  55. though c: is a good place.  And this doc file where you can get to it easily if
  56. you have questions later.
  57.     This program is run from CLI or shell.  Type "CDDARIP" Unit [device] <CR>
  58. where unit number is the SCSI number(0-6).  Device is entered if NOT using
  59. a Commodore 2091 card or A3000.  If you have either of these, do not enter 
  60. a device.  For a GVP controller on unit 3, you would type "cddarip 3 gvpscsi.device""'
  61. and so on.
  62.     A window will pop up in Workbench screen.  At the top is fifty squares with
  63. numbers in them.  These select a track on the disc.  If you have a CDDA disc
  64. inserted when starting, the valid tracks are highlighted.  Click on one of these
  65. with the mouse and it will start playing.  Just like my Sony player.  Below
  66. that is a rectangle with a status line in it.  Watch this space, the program may
  67. be telling you something.  During play, it will give the status, the track number,
  68. then the time from disc start, and time into track.  If you make an error, it
  69. will tell you.  If the drive is not connected correctly or wrong type of disc in
  70. you will get a CMD Sense Error.  This is the drive saying it cannot complete the
  71. command given it.  This is not a fatal condition, correcting the problem and
  72. retrying will remove this.  The program also queries the CDROM every half second
  73. or so to update status.  This will come up when changed.  
  74.     Next is a row of transport buttons.  These work like their counterparts on
  75. an audio player and do not need much explanation.   There is start of track,
  76. reverse scan, pause, play, forward scan, and next track.  Note there is no stop
  77. button,  this is not in the command set for some reason, use pause instead.
  78.     At the bottom, there are  four slightly longer buttons.  The  PLAY SEL
  79. will play the portion selected to be sampled as a preview.  It and all playing
  80. is done thru the Toshiba audio, NOT the Amigas.  When you are sure of what you
  81. want to sample, press CONVERT.  This will create the IFF file.  In this mode
  82. the double speed is disabled, and it takes whatever time the sample is to 
  83. convert, plus a little for overhead.  If you change your mind during a long
  84. sample, hit ABORT.  Keep in mind the partial result may not be usable.
  85. Keep in mind at the default 22KHz, that a five second sample is over 100K.
  86. make sure there is enough room available.  I do not recommend saving directly
  87. to floppies.  RAM may be used but be sure you have enough room.  
  88.     CHK DISC will update the track table AND SHOULD BE SELECTED ONCE AFTER THE
  89. CD IS CHANGED OR INSERTED.   Future versions may autosense this.  
  90.     On the right side are some parameters.  First is the Output Rate, this sets
  91. the sample rate.  Default is 22KHz or 1/2 the CD frequency.  11KHz can be selected
  92. to save RAM in non critical applications but quality is poor.  44KHZ or full 
  93. rate can also be used but most all Amigas cannot play back this fast so pitches
  94. will be flat.   Just below that is Output Mode.  This selects IFF MONO, which is
  95. a mono mix of both channels.  Also, left only or right only can be selected.
  96. Stereo was deleted because of format problems that require ALL left channel THEN
  97. all right channel data instead of interleaving them.  It is possible to take a
  98. left and a right sample and stitch them together in another program.
  99.     The next two string gadgets set the path and the file name.  This determines
  100. what the file created will be called.  This is pretty crude now and it is up to
  101. the user to set this and not write over any previous work.  
  102.     The bottem right contains two string and two button gadgets.  Start time
  103. is the time from start of disc that sampling will start at.  It can be set three
  104. ways.  Hitting the button called 'NOW' to the right will set it to the current
  105. play time in the status window.  Keep in mind this is not real accurate and will
  106. usually be 0.5-1 second later.  The next way is using keys to fine adjust.  Using
  107. the up and down arrow will add and subtract one frame (1/75 sec).  The PgUp and
  108. PgDn will add or subtract one second.  Holding the shift key during all this
  109. will multiply these by 8.  The third way is direct entry, click the mouse on
  110. either the min, sec or frame and change it.  If an invalid combo is entered, 
  111. a BCD error message will appear and the previous value returned.  The sample
  112. duration is set one of two ways.  First hitting the END button will set the 
  113. current play position to be the end point IF it is greater than the start time
  114. else it is ignored.  This can be directly entered as well.  No keys have been
  115. set to this yet, but may be in the future.
  116.  
  117.     The BCD format is:  MM:SS:FF     Where,
  118.         MM= minutes, can be 00-74.
  119.         SS= seconds, can be 00-59.
  120.         FF= frames , can be 00-74.  
  121.  
  122.     To exit, hit the close button in the upper left corner.  No requesters will
  123. appear, and no one will bug you about shareware fee.  This is not shareware at
  124. this point and would only become so if more complex features are added.  This
  125. has been an exploration and mastry of SCSI.  Note that the CD will continue
  126. to play even when stopped.  It may be desirable to hit pause first.  
  127.  
  128.  
  129. LEGAL:
  130.     CDDARip is © 1993 Jim Boros, all rights reserved.  
  131.     This softaware is not public domain but may be freely distributed provided
  132. that:   
  133.     1)  The program and documentation are not modified and are kept intact.
  134.     2)  This is not sold for any cost other than connect time or resonable
  135.         disk charge (<$6).
  136.     3)  It is not included in any commercial product.
  137.     
  138.     No warranties of any type, expressed or implied are granted.  I will
  139. not be liable for any damage to software or hardware, or any patent or copyright
  140. infringement arising out of this product.    This program is able to copy commercial music, and is supplied for test and
  141. educational purposes only.  Using samples from CD may require consent from the
  142. copyright holder.  Especially for commercial or publicly visible application.  
  143.  
  144.     The music industry probably has concerns about perfect duplication of CD and
  145. other digital audio.  This will not happen with CDDArip since the quality is 
  146. degraded to 8 bits, less than a good analogue copy.   Also the cost of media and
  147. drives for that magnitude of data would be many times the cost of the CD in a 
  148. record store.  
  149.     This may be distributed by Fred Fish, and by any BBS, and any redistributable
  150. software library.  And it may be distributed anywhere in the world.  
  151.         
  152. TO DO:
  153.         
  154.     Support for other audio formats, IE AIFF.  With slightly higher resolution.
  155.     More likely as higher quality sound becomes available for Amiga.        
  156.             
  157.     Clean up interface and make it a little easier to use.  
  158.     
  159.     Fix any bugs.            
  160.  
  161. CONTACT:
  162.  
  163.     I'm on BIX, the handle is jboros.  Leave any bug reports or suggestions 
  164. there.      
  165.  
  166.